home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat7 / ndbm.z / ndbm
Encoding:
Text File  |  1998-10-20  |  6.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. NNNNDDDDBBBBMMMM((((7777PPPP))))                                                              NNNNDDDDBBBBMMMM((((7777PPPP))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ndbm - local name service database
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      /var/ns/lib/libns_ndbm.so
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The ndbm client library fetches name service data out of an nnnnddddbbbbmmmm((((3333BBBB))))
  16.      format database file on the local host.  This library is meant to be used
  17.      only by the nnnnssssdddd((((1111MMMM)))) daemon to efficiently access local name service data.
  18.  
  19.      The library ////vvvvaaaarrrr////nnnnssss////lllliiiibbbb////lllliiiibbbbnnnnssss____nnnnddddbbbbmmmm....ssssoooo is opened by the nnnnssssdddd((((1111MMMM)))) daemon
  20.      when nnnnddddbbbbmmmm is listed as the protocol for some map in a nnnnsssssssswwwwiiiittttcccchhhh....ccccoooonnnnffff file.
  21.  
  22.      The library contains code to fetch data from a local ndbm file and
  23.      present it as lines from the configuration file from which it came.  The
  24.      nsd daemon then presents that data in the filesystem mounted under /ns.
  25.  
  26.      Extended attributes in the nnnnsssssssswwwwiiiittttcccchhhh....ccccoooonnnnffff file can be used to control the
  27.      behavior of the ndbm library.  Extended attributes are simply lists of
  28.      key/value pairs attached to each object in the nsd filesystem.  The
  29.      attributes supported in this library are:
  30.  
  31.      ddddoooommmmaaaaiiiinnnn
  32.           This is the domainname given as a parameter to the remote name
  33.           server.  This attribute is typically inherited from the daemon
  34.           depending on the nsswitch.conf file that is being read.  Given the
  35.           configuration file ////vvvvaaaarrrr////nnnnssss////ddddoooommmmaaaaiiiinnnnssss////DDDDOOOOMMMMAAAAIIIINNNNNNNNAAAAMMMMEEEE////nnnnsssssssswwwwiiiittttcccchhhh....ccccoooonnnnffff the
  36.           attribute "domain" is set to DOMAINNAME.  This attribute controls
  37.           which file is used to supply the requested information.  Given a
  38.           domain DOMAINNAME the library would open the file
  39.           ////vvvvaaaarrrr////nnnnssss////ddddoooommmmaaaaiiiinnnnssss////DDDDOOOOMMMMAAAAIIIINNNNNNNNAAAAMMMMEEEE////{{{{ttttaaaabbbblllleeee....ddddiiiirrrr,,,,ttttaaaabbbblllleeee....ppppaaaagggg}}}}.  If the domain
  40.           attribute is unset then the file ////eeeettttcccc////{{{{ttttaaaabbbblllleeee....ddddiiiirrrr,,,,ttttaaaabbbblllleeee....ppppaaaagggg}}}} would be
  41.           used.  See the information about the ttttaaaabbbblllleeee attribute below.  A
  42.           client system can be a member of multiple domains by including
  43.           multiple instances of the nnnnddddbbbbmmmm keyword in the nsswitch.conf file
  44.           like:
  45.                hosts: ndbm(domain=engr) ndbm(domain=corp)
  46.  
  47.      ttttaaaabbbblllleeee
  48.           The ttttaaaabbbblllleeee attribute is typically inherited from the daemon based on
  49.           the line from which this entry occurs in the nsswitch.conf file.  In
  50.           the above example the ttttaaaabbbblllleeee attribute would be set to hhhhoooossssttttssss....bbbbyyyynnnnaaaammmmeeee
  51.           or hhhhoooossssttttssss....bbbbyyyyaaaaddddddddrrrr depending on the context of the request.  This
  52.           attribute is used as the file name containing the ndbm data. Ndbm
  53.           databases are made up of two files, a directory file which has a
  54.           ".dir" extension and a data file which has a ".pag" extension.  For
  55.           the hhhhoooossssttttssss....bbbbyyyynnnnaaaammmmeeee map in the default domain the files
  56.           ////eeeettttcccc////hhhhoooossssttttssss....bbbbyyyynnnnaaaammmmeeee....ddddiiiirrrr and ////eeeettttcccc////hhhhoooossssttttssss....bbbbyyyynnnnaaaammmmeeee....ppppaaaagggg would be opened and
  57.           searched.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. NNNNDDDDBBBBMMMM((((7777PPPP))))                                                              NNNNDDDDBBBBMMMM((((7777PPPP))))
  71.  
  72.  
  73.  
  74.      kkkkeeeeyyyy  The kkkkeeeeyyyy attribute is used to fetch the data from the ndbm(3B)
  75.           database.  It is set by the nsd(1M) daemon, and is used without
  76.           alteration.
  77.  
  78.      ffffiiiilllleeee The ffffiiiilllleeee attribute overrides the domain and table attributes to set
  79.           the name of the file to be opened.  If the file begins with a
  80.           leading '/' then that file is simply opened.  If not, then the
  81.           contents of this attribute are appended to the directory name --
  82.           either ////eeeettttcccc//// for the default domain, or ////vvvvaaaarrrr////nnnnssss////ddddoooommmmaaaaiiiinnnnssss////DDDDOOOOMMMMAAAAIIIINNNNNNNNAAAAMMMMEEEE////
  83.           when the domain attribute is set.  The file should not have any
  84.           extension; the ".dir" and ".pag" are automatically appended when
  85.           opening the files.
  86.  
  87.      nnnnuuuullllllll____eeeexxxxtttteeeennnndddd____kkkkeeeeyyyy
  88.           The nnnnuuuullllllll____eeeexxxxtttteeeennnndddd____kkkkeeeeyyyy attribute specifies that the null character
  89.           which terminates the key is really part of the key.  Some
  90.           applications (such as sendmail) have historically included the null
  91.           in the key so this attribute provides backward compatibility with
  92.           the old behavior.
  93.  
  94. FFFFIIIILLLLEEEESSSS
  95.      /var/ns/lib/libns_ndbm.so
  96.  
  97. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  98.      nsd(1M), nsswitch.conf(4)
  99.      IIIIRRRRIIIIXXXX AAAAddddmmmmiiiinnnn:::: NNNNeeeettttwwwwoooorrrrkkkkiiiinnnngggg aaaannnndddd MMMMaaaaiiiillll
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.